home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu062.dms / pu062.adf / HamEdit.doc < prev    next >
Text File  |  1987-06-06  |  6KB  |  110 lines
  1. HamEditor9
  2. Written by James Carpino of Resolution Computer Research (RCR).
  3. I am placing this program in the public domain.
  4. This program may be copied in its
  5. entirety and distributed, and may not
  6. be used or sold for commercial use.
  7. Resolution Computer Research is currently a small non-profit
  8. software development company devoted to the development of
  9. software and hardware for the Commodore 64/128 and Amiga PCs.
  10. WE ARE NOT RICH so if you find any RCR programs useful
  11. please feel free to send a donation of $2 or more to:
  12. ---------------------------------\
  13. James Carpino                     |
  14. Resolution Computer Research      |
  15. 86-08 106th street Richmond Hill  |
  16. New York, NY 11418                |
  17. ---------------------------------/
  18. We are also currently working on:
  19. HAM (Hold-And-Modify) Image Editor: This is this program. Enjoy it.
  20. HAM library for C language, to use HAM in your own software.
  21.  
  22. Emily-64: a 6502 microprocessor emulator to enable the Amiga
  23.  to eventually run Apple II, Commodore 64, and Atari 800XE
  24.  software.  This will hopefully run at full speed, but we NEED
  25.  a developer's kit or Manx C compiler/assembler donation TO
  26.  accomplish this.
  27. Dimension-Three: AmigaBasic program to plot three-dimensional
  28.  formulas on any resolution screen (including interlaced).
  29. EditWave: AmigaBasic program to edit 256-byte waveforms with
  30.  sine, square, triangle, etc. waveforms and mixing.
  31. ---------------------------------------*
  32. Any donations will be recorded with the donor's name
  33. and put towards our development needs.  If, at any point,
  34. we succeed in developing products worthy of sale for a profit,
  35. any donations will be returned at the rate of twice the donated
  36. value.  Until we are on our feet (business-wise) we can make
  37. no promises as to the return of donated funds, equipment, etc.
  38. _____________________________________________________________________
  39. The Instructions:
  40.  
  41. How to use HamEditor9:
  42. Call the program from AmigaDos, using the following paramaters:
  43.    HamEditor9 h[height] w[width]
  44. for example:
  45.    HamEditor9 h300 w300    ;Creates a HAM screen 300 by 300 interlaced.
  46. Leaving out the h and w paramaters will cause HamEditor9 to default to
  47. the 320*400 screen format.  Any height over 232 will be made interlaced.
  48. Examples:
  49.    HamEditor9 h233         ;Creates a HAM screen 320 by 233 interlaced.
  50.    HamEditor9 w352         ;Creates a HAM screen 352 by 400 interlaced.
  51.    HamEditor9 h100 w100    ;Creates a HAM screen 100 by 100 non-interlaced.
  52.    HamEditor9 h230         ;Creates a HAM screen 320 by 230 non-interlaced.
  53. It is important to remember that the Amiga hardware can do low-resolution
  54. screens up to 352 dots in width, and high-resolution screens up to 704 in
  55. width.  Under Kickstart 1.1, though, these screens will not work properly
  56. unless perfectly centered by Preferences (the screen position slider).
  57. Under Kickstart 1.2, the screen will work properly regardless of the
  58. position of the Preferences screen slider, though you may not see all of
  59. it.  As for height, non-interlaced screens may go up to 232 in height and
  60. interlaced screens may go up to 464 in height.  Again, if the screen is not
  61. positioned correctly, it may not work properly under Kickstart 1.1.  If the
  62. screen is above 200 or 400 interlaced, 1.1 will not show that part which
  63. streches over the limit.  The only way to remedy this in 1.1 is to go to the
  64. top of the screen, and drag the screen drag bar upwards until all the screen
  65. is visible.  The screen will not move, but the bottom border will, and the
  66. mouse pointer will point to a position several dots lower.  In Kickstart
  67. 1.2, the entire screen will automatically be visible (provided the
  68. Preferences screen position gadget is in the upper left corner).
  69.    "Wait a minute-  did he say ALL?  Uh- I can't see all of it, my 352 by
  70. 464 screen goes off the screen no matter what I do!" says a fairly well-
  71. educated observer.  He has a problem: His monitor will not physically accept
  72. a screen much larger than 320 (or 640 hi-res)  by 200 (or 400 interlaced).
  73. This is true of all the current Commodore monitors and most color monitors.
  74. They do something called overscanning. This is so the scanning gun in the
  75. CRT (Cathode Ray Tube) has time to get from the right of the screen to the
  76. left of the screen, and from the top to the bottom.  It is different on most
  77. monitors (TV's, composite, RGB, etc.) so Amiga has the position gadget in
  78. Preferences.  If you have a monochrome monitor, or an old-fashioned color TV
  79. with all the controls, you can change the Horizontal and Vertical size;
  80. usually the smallest settings will allow for most of a 352 by 232 screen to
  81. be displayed.  Some expensive RGB monitors will display the larger screens,
  82. too.
  83.    Now, back to our little graphics editor.  The commands are summarized as
  84. follows:
  85.    d  --Goes to draw mode (full lines), just like in DeluxePaint.
  86.    s  --Goes into spots mode (dotted lines), just like DeluxePaint.
  87.    , (comma key) --Picks a color from anywhere on the screen, like in
  88.       DeluxePaint.  This can be held down to roll through the pallette.
  89.    . (period key) --Changes the brush size to something easy to work with.
  90.    - (minus key) Reduces the X and Y size of the brush. (DeluxePaint)
  91.    = (Equals key, look at the plus sign) Increases the width of the brush.
  92.    \ (Backslash key, next to the = key) Increases the height of the brush.
  93.    HELP --Redraws all the information, including the palette.
  94.    F10 --Pops in and out the MENU bar, to allow for the full screen height.
  95.    [ and ] --Change the current color to one of the 16 colors; these are
  96.      fast and are not HAM colors. (These keys also work in DeluxePaint)
  97.    8-9,5-6,2-3: Up and down for HAM red, green, and blue.  The current HAM
  98.      color is also displayed as ham color #8. (These keys also work in
  99.      DeluxePaint)
  100.    Del --(above the BackSpace key)  Clears the screen and re-draws all the
  101.      information (Like HELP with a clear screen first).
  102.  
  103. The penwidth can be no less than 3 dots wide because it takes 3 dots to make
  104. a HAM color: 1 for red, 1 for green, and 1 for blue.  If you have to
  105. increase the size of the brush drastically, increase the height; height is
  106. drawn faster than width.
  107. That's about it, if I forgot anything else, you'll discover it soon enough.
  108. Most of all, have fun, and Happy Hamming!
  109.  
  110.